Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update contribute.ja.html #78

Closed
wants to merge 1 commit into from
Closed

Update contribute.ja.html #78

wants to merge 1 commit into from

Conversation

askdkc
Copy link
Contributor

@askdkc askdkc commented Aug 11, 2022

英語版同様 poではなくmdファイルに飛んで欲しい。

と言うのも、最初ドキュメント修正に貢献しようとリンククリックした時に「poって何?」と諦めてしまったので、参加者のハードルを下げる意味でもここをmdに飛ばすのが良いかと思いました。

英語版同様 poではなくmdファイルに飛んで欲しい。と言うのも、最初ドキュメント修正に貢献しようとリンククリックした時に「poって何?」と諦めてしまったので、参加者のハードルを下げる意味でもここを変えて欲しいと願うリクエストです。
@komainu8
Copy link
Member

なるほど。確かに初見の人は.poがなんだかわからないですね。。。ありがとうございます。

ただ、日本語への翻訳は.mdを直接編集ではなく、英語版の.mdを作成し、rake jekyll:i18n:translateコマンドで.edit.poを作成してそれを編集して再度rake jekyll:i18n:translateを実行して日本語の.po.mdを生成するという仕組みになっています。(つまり、日本語の.po.mdは直接編集しません。)
こうすることで、同じ翻訳を使い回せるようにしてあります。

なので、直接日本語の.mdに飛ばすよりは、 https://groonga.org/ja/docs/contribution/documentation/i18n.html のように翻訳の方法を書いたページを作ってそこに飛ばすようにしたほうが良さそうです。

@askdkc
Copy link
Contributor Author

askdkc commented Aug 15, 2022

そう言えば英語から日本語版を作るやり方でしたね。失礼しました😵

最初に飛ばされた.poファイルで困惑したので、日本語の場合にはコントリビューションガイドに飛ばすのが良いかと思いました。

@kou
Copy link
Member

kou commented Aug 15, 2022

(PGroongaユーザーである)Zulipとかも使っている https://www.transifex.com/ を利用するとかしてもっと簡単に.poを変更できる仕組みを用意したほうがよいかも。

ローカルでエディターで.edit.poを変更するのが楽な人はそっち、初見の人とかは https://www.transifex.com/ とか。

@askdkc
Copy link
Contributor Author

askdkc commented Apr 16, 2023

マークダウンだと表示されるコードのコピペボタンがPGroongaのドキュメントでも出て来ると「いい感じ」になれる気がするんですが、コードハイライト機能部分がもっといい感じにならないですかね?

image

@komainu8
Copy link
Member

コピーボタンのフォームをHTMLで書いて、JavaScriptでクリップボードにコピーする処理を書いて https://github.com/pgroonga/pgroonga.github.io/tree/master/_includeshttps://github.com/pgroonga/pgroonga.github.io/tree/master/assets に配置して https://github.com/pgroonga/pgroonga.github.io/tree/master/assets/stylesheets で組み込めばできそうな気がします。

改善案として https://github.com/pgroonga/pgroonga.github.io/issues に切り出していただけると助かります。

@askdkc
Copy link
Contributor Author

askdkc commented Apr 17, 2023

@komainu8 さん

ありがとうございます!

下記のissueとして追加しました〜
#113

@askdkc askdkc closed this by deleting the head repository Jun 26, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants